클로드 코드 완벽 가이드 — 22장 Super Claude 딥다이브 학습 노트

출처: 클로드 코드 완벽 가이드 (코드팩토리 최지호) | 참고: https://github.com/codefactory-co

22장에서 다루는 내용

• Super Claude 개요 — 클로드 코드에 파인튜닝된 커스텀 프롬프트를 자동 생성하는 프레임워크
• 설치 및 설정 — uv 패키지 매니저 기반 설치, 설치 마법사 실행
• 16가지 커스텀 커맨드 — /sc: 접두사로 실행하는 전문 분석·구현·테스트·문서화 명령어
• 11가지 페르소나 — architect, frontend, backend, qa 등 역할별 전문 AI 프로필
• 4가지 MCP 통합 — Context7, Sequential Thinking, Magic UI, Playwright
• 커스텀 플래그 시스템 — 플래닝, 사고 깊이, 효율, 오케스트레이션, 스코프 제어
• 고급 워크플로 패턴 — 대규모 코드베이스 관리, 레거시 시스템 개선 실전 사례

전체 흐름도

[Super Claude 설치]              [커스텀 커맨드 (16종)]           [고급 워크플로]
    |                                |                              |
    v                                v                              v
+-------------------+   +------------------------+   +---------------------------+
| 1. uv 설치        |   | 분석: /sc:analyze       |   | 대규모 코드베이스          |
| 2. 설치 스크립트   |   | 구현: /sc:implement     |   |  --delegate auto --uc     |
| 3. 마법사 실행     |   | 빌드: /sc:build         |   |  --focus architecture     |
| 4. 기본 설치 선택  |   | 개선: /sc:improve       |   |                           |
| 5. sc 폴더 생성    |   | 디버깅: /sc:troubleshoot|   | 레거시 시스템 개선          |
|                   |   | 테스트: /sc:test        |   |  --persona-architect      |
| 설치 완료!        |   | 문서: /sc:document      |   |  --ultrathink             |
+-------------------+   | Git: /sc:git           |   |  --wave-mode --safe-mode  |
                        | 설계: /sc:design       |   |                           |
    [페르소나 (11종)]   | 학습: /sc:explain      |   | 자동 트리거               |
    |                   | 정리: /sc:cleanup      |   |  프롬프트 키워드 기반     |
    v                   | 로드: /sc:load         |   |  페르소나+MCP 자동 활성화 |
+-------------------+   | 추정: /sc:estimate     |   +---------------------------+
| architect         |   | 멀티: /sc:spawn        |
| frontend/backend  |   | 작업: /sc:task         |
| security/qa       |   | 워크플로: /sc:workflow  |
| performance       |   | 인덱스: /sc:index      |
| analyzer          |   +------------------------+
| refactorer        |
| mentor/devops     |       [MCP (4종)]
| scribe            |       |
+-------------------+       v
                    +---------------------------+
                    | Context7    (--c7)        |
                    | Sequential  (--seq)       |
                    | Magic UI    (--magic)     |
                    | Playwright  (--play)      |
                    +---------------------------+

선수 지식 체크리스트

• [ ] 클로드 코드 기본 사용법 (프롬프트 입력, 명령어 실행)
• [ ] MCP(Model Context Protocol) 개념 이해
• [ ] 커스텀 프롬프트 / 커스텀 명령어의 기초
• [ ] uv 또는 pip 같은 패키지 매니저 사용 경험
• [ ] 터미널(CLI) 기본 조작 능력

핵심 키워드

22-1 Super Claude 개요 및 설치

한 줄 요약

Super Claude는 클로드 코드의 프롬프트와 MCP를 자동으로 설정해주는 프레임워크로, uv 설치 후 스크립트 한 줄로 설치할 수 있다.

쉬운 설명 (비유)

일반 클로드 코드 = 만능 요리사 한 명
Super Claude     = 요리사에게 레시피북 + 전문 조리도구 세트를 한꺼번에 제공

❌ 직접 프롬프트를 작성하고 MCP를 하나하나 설정하는 방식
✅ Super Claude가 파인튜닝된 프롬프트 + MCP를 자동으로 세팅

실무 예제

# 1단계: uv 설치 (패키지 매니저)
# GitHub의 Install with uv 섹션 참고

# 2단계: 슈퍼 클로드 설치 스크립트 실행
# uv 설치 후 제공되는 스크립트 실행

# 3단계: Finish Installation 스크립트 실행 → 설치 마법사 시작

# 4단계: 마법사에서 1(기본 설치) 선택 → y 두 번 입력

# 5단계: 설치 완료 확인
# /Users/${사용자}/.claude/commands 폴더에 sc 폴더 생성됨
ls ~/.claude/commands/sc/
# → 16개의 커맨드 파일이 존재하면 설치 완료!

핵심 체크포인트

• [ ] Super Claude는 프롬프트 + MCP 설정을 자동화하는 프레임워크이다
• [ ] 설치 전에 uv 패키지 매니저가 먼저 필요하다
• [ ] 공식 깃허브: github.com/SuperClaude-Org/SuperClaude_Framework
• [ ] 설치 완료 후 ~/.claude/commands/sc 폴더가 생성된다
• [ ] 프롬프트가 매우 정교하여 토큰 사용량이 많지만 성능 향상이 크다

22-2 커스텀 커맨드 (16가지)

한 줄 요약

Super Claude는 /sc: 접두사로 실행하는 16가지 전문 커맨드를 제공하며, 각 커맨드가 특화된 프롬프트로 클로드 코드의 응답 품질을 극대화한다.

쉬운 설명 (비유)

일반 클로드 코드에게 "이 코드 분석해줘" = 범용 질문
/sc:analyze 사용 = 전문 코드 분석가에게 체계적 분석 의뢰

마치 종합병원에서:
❌ "아파요" → 접수 창구에서 대충 답변
✅ "/sc:troubleshoot" → 전문의에게 정밀 검사 의뢰

전체 커맨드 분류표

실무 예제

# 코드베이스 분석
/sc:analyze src/

# 새로운 API 기능 구현
/sc:implement "사용자 인증 API를 만들어줘"

# 버그 디버깅
/sc:troubleshoot "로그인 실패 오류 해결해줘"

# 테스트 작성 및 실행
/sc:test src/auth/

# 프로젝트 문서 자동 생성
/sc:document src/

# 어떤 커맨드를 써야 할지 모를 때
/sc:index "코드 리팩터링하고 싶어"

핵심 체크포인트

• [ ] 모든 커맨드는 /sc: 접두사 + 커맨드명으로 실행한다
• [ ] 커맨드는 sc 폴더 내부에 있으므로 sc 접두사가 필수이다
• [ ] v3 기준 총 16가지 커맨드가 제공된다
• [ ] /sc:index로 상황에 맞는 커맨드를 추천받을 수 있다
• [ ] 각 커맨드는 내부적으로 파인튜닝된 프롬프트를 사용한다

22-3 페르소나 (11가지)

한 줄 요약

Super Claude는 11개의 전문 페르소나를 제공하며, 프롬프트 키워드에 따라 자동으로 활성화되거나 --persona 플래그로 강제 지정할 수 있다.

쉬운 설명 (비유)

페르소나 = AI에게 입히는 전문가 유니폼

❌ 범용 AI에게 "보안 점검해줘" → 얕은 수준의 검토
✅ security 페르소나 활성화 → 보안 전문가처럼 심층 점검

마치 종합병원에서:
"내과 전문의" 페르소나 = backend
"외과 전문의" 페르소나 = refactorer
"응급의학과"  페르소나 = analyzer

페르소나 분류 및 개발 단계 매핑

개발 단계별 추천 페르소나

실무 예제

# 자동 활성화: "architecture"가 포함되어 architect 페르소나 자동 트리거
/sc:design "마이크로서비스 architecture를 설계해줘"

# 강제 활성화: --persona 플래그로 직접 지정
/sc:design --persona-architect "모놀리식 앱을 마이크로서비스로 전환해줘"

# 보안 전문가로 코드 분석
/sc:analyze auth/ --focus security
# → security 페르소나 자동 활성화

핵심 체크포인트

• [ ] 총 11가지 페르소나가 있으며 각각 전문 영역이 다르다
• [ ] 프롬프트에 특정 키워드가 포함되면 자동으로 해당 페르소나가 활성화된다
• [ ] --persona-[이름] 플래그로 강제 활성화할 수 있다
• [ ] 개발 단계(계획->구현->테스트->유지보수->배포)에 따라 적합한 페르소나가 다르다
• [ ] 페르소나와 MCP는 독립적으로 조합 가능하다

22-4 MCP 통합 (4가지)

한 줄 요약

Super Claude는 Context7, Sequential Thinking, Magic UI, Playwright 4개의 MCP를 내장하며, 프롬프트 키워드에 따라 자동 실행되거나 플래그로 강제 실행할 수 있다.

쉬운 설명 (비유)

MCP = AI에게 연결하는 전문 도구 장비

Context7      = 도서관 사서 (최신 공식 문서를 즉시 찾아줌)
Sequential    = 수학자의 풀이 노트 (단계별로 깊이 분석)
Magic UI      = 인테리어 디자이너 (UI 컴포넌트 자동 생성)
Playwright    = 테스트 로봇 (브라우저를 자동으로 조작·검증)

MCP 상세 비교표

실무 예제

# React 공식 문서를 참조하여 앱 빌드
/sc:build react-app/ --c7
# → Context7 MCP가 React 모범 사례를 자동으로 가져옴

# 인증 흐름 버그를 단계별로 분석
/sc:troubleshoot "auth flow broken" --seq
# → Sequential Thinking MCP가 단계별 분석 수행

# 대시보드 UI 자동 생성
/sc:build dashboard --magic
# → Magic UI MCP가 최신 UI 컴포넌트를 생성

# E2E 테스트 자동 실행
/sc:test e2e --play
# → Playwright MCP가 브라우저 자동화 테스트 수행

핵심 체크포인트

• [ ] Super Claude에는 4개의 MCP가 내장되어 있다
• [ ] MCP도 페르소나처럼 프롬프트 키워드에 따라 자동 실행된다
• [ ] 강제로 실행하려면 --c7, --seq, --magic, --play 등의 플래그를 사용한다
• [ ] MCP와 페르소나는 독립적으로 조합 가능하다
• [ ] Sequential Thinking은 토큰을 많이 사용하지만 복잡한 문제에 효과적이다

22-5 커스텀 플래그

한 줄 요약

Super Claude는 플래닝, 사고 깊이, 효율/컨트롤, 오케스트레이션, 스코프의 5가지 카테고리에 걸친 플래그를 제공하여 커맨드의 동작을 세밀하게 제어한다.

쉬운 설명 (비유)

플래그 = 요리할 때의 '불 조절 다이얼'

--plan        = 레시피 미리보기 (요리 시작 전 계획 확인)
--think       = 중불 (적당한 깊이 분석)
--think-hard  = 강불 (깊은 분석, 시간 소요)
--ultrathink  = 최강불 (가장 깊은 분석, 토큰 많이 소모)
--uc          = 압축 포장 (60-80% 토큰 절약)
--safe-mode   = 안전장치 ON (위험한 변경 방지)

플래그 분류 정리

1. 플래닝 및 분석 플래그

2. 효율 및 컨트롤 플래그

3. 오케스트레이션 플래그

4. 포커스 및 스코프 플래그

실무 예제

# 빌드 전에 실행 계획 확인
/sc:build --plan
# → 빌드 단계를 미리 확인할 수 있음

# 대규모 코드베이스 분석 (토큰 절약 + 병렬 처리)
/sc:analyze huge-codebase/ --uc --delegate auto

# 프로덕션 코드 안전하게 수정
/sc:improve production-code/ --safe-mode --validate

# 학습 목적으로 상세 설명
/sc:explain React hooks --verbose --answer-only

# 레거시 시스템 심층 분석
/sc:analyze legacy/ --ultrathink --persona-architect

핵심 체크포인트

• [ ] 플래그는 커맨드 뒤에 -- 접두사로 추가한다
• [ ] 사고 깊이: --think(4K) -> --think-hard(10K) -> --ultrathink(32K) 순으로 깊어진다
• [ ] --uc는 토큰을 60-80% 절약하는 압축 모드이다
• [ ] --delegate는 대규모 분석 시 하위 에이전트에게 작업을 분산한다
• [ ] 플래그는 수동 지정뿐 아니라 조건에 따라 자동 활성화되기도 한다
• [ ] --safe-mode와 --validate는 프로덕션 환경에서 안전 장치 역할을 한다

22-6 고급 워크플로 패턴 및 사용 예제

한 줄 요약

Super Claude의 커맨드, 페르소나, MCP, 플래그를 조합하면 대규모 코드베이스 관리부터 레거시 시스템 개선까지 실무 수준의 자동화 워크플로를 구성할 수 있다.

쉬운 설명 (비유)

개별 도구 사용     = 연필 한 자루로 그림 그리기
고급 워크플로 조합 = 전문 화구 세트 + 조명 + 캔버스로 작품 제작

❌ /sc:analyze src/ (기본)
✅ /sc:analyze monorepo/ --delegate auto --uc --focus architecture
   → 병렬 처리 + 토큰 절약 + 아키텍처 집중 = 최적화된 워크플로

자동 트리거 시나리오

프런트엔드 작업 → frontend 페르소나 + Magic MCP 자동 트리거
/sc:build src/components/

보안 분석 → security 페르소나 + Sequential MCP 자동 트리거
/sc:analyze auth/ --focus security

퍼포먼스 검증 → performance 페르소나 + Playwright MCP 자동 트리거
/sc:analyze --focus performance slow-endpoints/

대규모 코드베이스 관리 워크플로

# 효율적인 대규모 분석
/sc:analyze monorepo/ --delegate auto --uc --focus architecture
# → 평행 작업 + 압축하기 + 아키텍처에 집중하기

# 시스템적 개선
/sc:improve legacy-system/ --wave-mode auto --safe-mode
# → 여러 스텝에 걸친 개선. 중간 중간 확인하기

# 포괄적 코드 리뷰
/sc:analyze enterprise-app/ --delegate folders --focus quality
# → 분산된 퀄리티 분석

레거시 시스템 개선 워크플로

# 1단계: 평가 (architect 페르소나 + 최대 심층 분석)
/sc:analyze legacy/ --persona-architect --ultrathink
# → 아키텍처 깊게 분석하기

# 2단계: 계획 수립 (실행 전 계획 확인)
/sc:design --plan modernization-plan

# 3단계: 단계적 개선 (안전 모드 + 다단계 실행)
/sc:improve legacy-system/ --wave-mode auto --safe-mode

# 4단계: 검증 (테스트 + 브라우저 자동화)
/sc:test --play e2e-tests/

핵심 체크포인트

• [ ] 커맨드 + 페르소나 + MCP + 플래그를 조합하여 고급 워크플로를 만든다
• [ ] 프롬프트 키워드에 따라 적절한 페르소나와 MCP가 자동으로 트리거된다
• [ ] 대규모 프로젝트는 --delegate + --uc 조합이 효과적이다
• [ ] 레거시 개선은 분석 -> 계획 -> 개선 -> 검증 4단계로 진행한다
• [ ] 플래그를 억지로 많이 적용할 필요 없이 자동 트리거를 활용한다

연습문제

문제 1: 커맨드 선택 (기본)

다음 상황에서 가장 적합한 Super Claude 커맨드를 고르세요.

"새로운 REST API 엔드포인트를 만들어야 한다."

• A) /sc:analyze
• B) /sc:implement
• C) /sc:troubleshoot
• D) /sc:test

문제 2: 플래그 조합 (중급)

대규모 모노레포(50개 이상 파일)를 분석하면서 토큰을 절약하고 싶다. 어떤 플래그 조합이 가장 적절한가?

• A) --think --verbose
• B) --delegate auto --uc
• C) --ultrathink --safe-mode
• D) --plan --answer-only

문제 3: 페르소나 자동 활성화 (중급)

다음 커맨드를 실행했을 때 자동으로 활성화될 가능성이 가장 높은 페르소나는?

/sc:analyze auth/ --focus security

• A) architect
• B) frontend
• C) security
• D) qa

문제 4: 워크플로 설계 (고급)

레거시 시스템을 현대화하려고 한다. 가장 효과적인 4단계 워크플로를 순서대로 나열하시오.

부록 A: 용어사전

부록 B: 비교표

사고 깊이 플래그 비교

페르소나 vs MCP vs 플래그 비교

Super Claude vs 일반 클로드 코드 비교

부록 C: 참고자료